Upgrade StarTeam

If you have used previous releases of StarTeam Server, you must upgrade each of your server configurations after installing the new release. The upgrade process varies depending upon:

Which database you are using.
Which previous release of StarTeam Server you are using.

To determine if a patch is required before you upgrade, contact Technical Support at: https://www.microfocus.com/support .

Overview of the upgrade process

You can upgrade to the latest version of StarTeam Server only from StarTeam Server 2014 or higher. If you are on an earlier release, contact support for a customized upgrade plan. The customized upgrade plan takes into consideration the previous versions of the Operating System and database in use, and may require multiple steps.

For StarTeam Server 2014 or higher, follow the steps below:

Back up your StarTeam repositories and other server files.
If necessary, upgrade or migrate your database to a version supported by StarTeam Server <latest version>. For details on migrating a database, see Database requirements for upgrading.
Install the latest version of the StarTeam Server .

After the upgrade, the server file location is changed. The old starteam-server-configs.xml file is copied from the old StarTeam Server release’s installation folder to the new release’s installation folder. This ensures that all configurations running on the previous StarTeam Server release can access the new StarTeam Server release.

Preparing for an upgrade

Before upgrading, do the following:

Perform test upgrades

We strongly recommend running test upgrades against copies of current production databases.

Create an upgrade schedule

Plan your StarTeam Server upgrade when it will inconvenience the smallest number of users. A StarTeam Server configuration cannot be running during some of the steps you take before and during the upgrade. You may want to plan the StarTeam Server upgrade at the end of the workday or perhaps on a weekend. If you have a large repository or a slow system, the upgrade process could be time consuming. Depending on the size of your database, you might need to schedule a couple of down-times for the upgrade. For example, you might schedule one weekend for upgrading the StarTeam Server and another for upgrading the database. Make backups before and after each of these steps to prevent loss of data.

Advise your team ahead of time that you plan to make this transition during a specified period of time, and advise them when they will need to have the latest version of a StarTeam client installed. Unless specifically stated, StarTeam clients for a given release work with that StarTeam Server release, one release back, and one release forward. When an older client works with a newer StarTeam Server, the client cannot access new features. For example, the older client cannot display any new menu commands.

Backup the server configuration

Make certain you have current, verified backups of the files and folders for the StarTeam Server configuration (database files, archive files, and so on) prior to starting important steps in the upgrade process.

Requirements for an upgrade

This section describes the steps that you follow to upgrade to the latest version of StarTeam Server, elaborating on the table provided in Overview of the upgrade process and providing references to related sections for more detailed information. Before upgrading to the latest version of StarTeam Server, you need to:

Review the pre-installation issues for a new installation to determine whether any of them apply to you.
You can upgrade to the latest version of StarTeam Server only from StarTeam Server 2009 R2+. If you are on an earlier release, take the steps necessary to upgrade from that release to StarTeam Server 2009 R2. See the appropriate installation guides for details. Be sure to also install the latest patches. You can find information about the latest patches at https://www.microfocus.com/support.
Back up your StarTeam repositories and other server files. See the documentation for the release of StarTeam Server that you currently have installed for information about what to back up.

You cannot install StarTeam Server while server configurations are running. Therefore, you must perform one of the following procedures.

To shut down a StarTeam Server configuration that is not running as a Microsoft Windows service:

Open the Server Administration tool, by selecting Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server. The Server Administration tool opens.
Select the server configuration, and choose Actions > Shut Down Server. After you confirm that you want to shut down the server, the Status icon changes from Running to Stopping to Ready.

If your StarTeam Server configurations run as Microsoft Windows services, you must stop those services and change the StarTeam execution mode:

Click Start > Settings > Control Panel > Administrative Tools > Services. The Services window opens.
Locate the Server configuration and click Stop.
After the service stops, close the Services dialog box and the Control Panel.
Stop the server configuration from being run as a service. For example, in Server 2009 R2, start the Server Administration tool by selecting Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server. The Server Administration tool opens.
Select the server configuration, and choose Actions > Set to Run as Service. This menu command changes from checked to unchecked, indicating that the server configuration is no longer running as a service. The server configuration’s icon also changes.

Install the latest version of StarTeam Server on the same computer as the version of Server that you are upgrading from.
If necessary, upgrade or migrate your database to a version supported by Server latest version. For more information, see Database requirements for upgrading.
Note: Performing the StarTeam Server installation and the database upgrade in different sessions, such as different weekends, allows you to isolate any problems to one step or the other. If your database version is not one that is supported by the latest version of StarTeam Server, perform the database migration prior to installing the latest version of StarTeam Server. If performing an upgrade of both the StarTeam Server and the database, upgrade the database, install StarTeam Server, then upgrade or migrate your database to another database version.
Upgrade your server configurations. For more information, see Upgrading server configurations.

Upgrading server configurations

After you install StarTeam Server, every existing server configuration must be upgraded.

To upgrade the server configurations:

Open the Server Administration tool by clicking Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server
Select the server configuration to be upgraded. Even if the status for the server configuration indicates Ready, the server configuration will not start successfully until you run the upgrade procedure.
Click the Upgrade Database toolbar button. A series of dialog boxes may open and close. At the completion of the process, a message indicates a successful upgrade operation. If an error occurs, a message displays the error information. The upgrade process creates a log file named DBUpgrade.locale.log in the server configuration's repository folder. For example, if the locale is the United States, the name of the file is DBUpgrade.en-US.log.
Note: The upgrade process requires one database connection to run. If the upgrade process is unable to acquire a connection, it will fail.
Check the database connection information on the StarTeam Server computer. From the computer on which the server is installed:
1. Open the Server Administration tool.
2. Select the server configuration.
3. Click Server > Configuration Properties.
4. From the Properties dialog box, select the Database Connections tab.
5. Click Verify.
  Ensure that the database is running.

Post-Installation tasks for an upgrade

If you are upgrading from a previous release of StarTeam Server, be aware of the following: